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1.20 SCOPE 
1.0 SCOPE 
This document describes the external features and 


characteristics of CYBIL-CC Interactive Debugs a supervisor 
program running under the NOS operating system. It is primarily 
directed toward CYBER 180 software devetopment programmers who 
are assumed to be familiar with CYBIL-CC and NOS. 


lel APPLICASLE DOCUMENTS 


Publication Number 

NOS Reference Manual Votume 1 60445400 
NOS Reference Manual Volume 2 60445300 
Network Products Interactive Facility 

Version 1 Reference Manual 60455250 
Network Products Interactive Facility 

Users Guide 60455260 
CYBER Interactive Debug 

Version 1 Reference Manual 60481400 
CY3IL Language Specification ARH2298 
CYBIL V2.0 Implementation Dependent ARH3078 

Handbook 
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260 INTRODUCTION 


CYBIt-CC Interactive Debug (CCDBG) extends the capabilities of 
CYBER Interactive Debug (CID) to allow symbolic debugging of 
CY3IL-CC orograms. Locations within a CYBIL-CC program can be 
referenced by variable names and fine numbers if the program was 
compifted with the DEBUG option selected. This option causes 
CYBIL-CC to produce special tables For CCDBG as part of the 
object code, 


The CID command syntax has been completely changed in CCDBEG to 
make it conform with the N9QS$/130 System Command Language. Also» 
many changes have been made to the parameters of most commands to 
handie CYBIL-CC moduless procedures and stacks instead of Fortran 


structures. The overall capabilities of CCDBGs» howevers differ 
fittie from those of Cio. There are only four new 
commands: FORWARD» BACKWARD» DISPLAY_DEFAULTS and 


CHANGE_DEFAULTS. The COMPASS or machine tevel capability of CID 
has been maintaineds and the overall design of CID has not been 
changed. 


2e1 QVERVIEYW 


CCOBG is a supervisory program loaded in the user field length 
to operate on toaded object programs. No special source 
statements are needed in the program to be debugged} howevers a 
special comelier estion must be selected if syabsciic debugging is 
desired. In addition to its symbolic referencing capabilitiess 
CCD98G controls program execution as determined by user-defined 
breakpoints and traps» allows the user to look at and change 
memory and registerss and defines a sequence of CCDBG commands 
and gives them a procedure name so that they wit! execute each 
time the name is referenced or on occurrence of a specified 
breakpoint or trap. Breakpoints trap and procedure definitions 
may be saved on a file for use in future sessionss and the 
session may be checkpointed to be restarted tater. 
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202 TERMINDLOGY 


Breakpoint 


Defauit 
Module 


Default 
Proc 


Entry Point 


Expression 


Heap 


Interactive 


Interpret 


Map 


A location within a program where the program's 
execution may be interrupted by a monitor routine. 


The name of the CYBIL-CC module that was executing 
when CCD8G gained controls unless a subsequent 
CHANGE_DEFAULTS command specified a new module name 
as the default module. At initial start-up of 
CCOBGs, the default module is the module at which 
program execution is to begine Default module is 
equivalent to HOME PROGRAM In CID. 


The CYBIL-CC procedure that was executing when 
CCDBG gained controls untess a subsequent 
CHANGE_DEFAULTS command specified a new procedure 
name as the default proc. At initial start-up of 
CCDBGs the default proc is undefined. 


A special named focation within a program which may 
be accessed by programs compiled separatety. If 
there is an aliassy the alias name will be used. 
Entry points are timited to 7? characters by the 
CYBER Loaders if they are Jfonger than 7 characterss 
oniy the First 7 characters will be used. To 
reference an entrypoint that contains a character 
that is not ftegal in a names the entrypoint name 
must be enclosed in single quotes. 


An algorithm used for computing a value. A CCDBG 
expression may contain symbolic address references,» 
CCD8G variabiess numeric literals», and the 
Anawntnarn 4 ane i. Tine wm a RR ete ee OH aah ea acs temas | Sk 
VMN uae DF aiu “ee imac y way vo wWavou LU CAPT ess af 


address or a value. 


A dynamic storage area explicitiy allocated and 
freed by CYBIL-CC programs. 


Capable of a two-way back and forth exchange of 
information. 


Execution of computer machine instructions by other 
than direct means. A special routine examines each 
instruction and simulates its execution. 


A list of module and entry point memory addresses» 
produced when the program is loaded. 
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Module A compilation unit in CYBIL-CC. This is the alias 
defined in CYBIL-CC or the first 7 characters of 
the module name if there is no aliase To reference 
a module which contains a character that is not 
legal in a names the module name must be enclosed 
in single quotes. 


Nested A procedure that is defined within another 
procedure. 


Overlay A portion of a program which can share an area of 
memory with other simitar program portions. When 
access to a particular portion of the program is 
requireds the overtay containing that portion is 
loaded» overtaying the previous contents of the 
memory are@ae 


Procedure A named portion of a program in CYBIL-CC. This is 
the actual name defined in CYBIL-CC»s not an alias. 


Program The completely loaded set of one or more modules. 


Separator A character required between two items so that they 
may be distinguished. [In CCDBGs spaces or commas 
are used as separators between parameters and 
between elements in a lists and semi-colons and 
end-of-line are used as separators between 
commands. 


Stack A dynamic storage area automaticaily allocated by 
CYB8IL-CC programs on each procedure call. 


Trace | An ordered tist of procedures or modules that have 


» 
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Throughout this documents whenever a CCDBG command is 
discussed» the manner of writing that command is iftlustrated with 
a uniform system of notation. This notation is cailed a 
metalanguage and is not part of CCDB8G. Through the use of a 
metalanguage we are able to provide a briefs but precises 
expfanation of the generat patterns that CCDBG permits. The 
metalanguage does not describe the meaning of the language 
elements, merely their structure; ieees it indicates the order in 
which the elements may (or must) appears punctuation that is 
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regqguireds and options that are allowed. These following 
metalanguage rules apply: 


1) The symbol *?= is read as “IS DEFINED TO BE". 


2) Elements enclosed by << > are to be considered a single 
syntactic unit in retation to surrounding meta symbols. 


3) Elements enclosed by C€ J] are optional and are to be 
considered a single syntactic unit in relation to surrounding 
meta symbols. 


4) Elements separated by H are mutuatty exclusives and the 
symbol is read as "OR", 


5) Elements Followed by «2. can be repeated, 
6) <e2r> will be used to indicate that an ellipsis (two or more 
Periods) is required. In this cases the ellipsis is part of 


the language. 


7) ascii> wili be used to indicate that an ascii character is 
required. 


8) <sp> wiii be used to indicate that a space is required, 


9) The symbol EOL will be used to indicate end of line. 


20% BASIC CONCEPTS 


<integer> 235 <dec_digit> [<digit>...] [t<base>)] 


Integers nay be expressed as octal (8)5 decimal (10)»5 or 
hexadecimal (16). When the base specification is omitteds 
decimai (19) is assumed. When a hexadecimal representation is 
specified» a teading zero may be required to ensure that the 
constant begins with a decimal digit. 
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202402 NAME 


€name> 232 Calpha> [<alphari<digit>] 2. 


A name is a string of alphanumeric characters not contained in 
a comment or constant. The name must be preceded and followed by 
a delimiter. Any character not allowed inside a name delimits a 
names The initial character of a name must not be a digit and 
the number of characters in a name must not exceed 31. 


20403 ADDRESS 


address> ii= <expr>d 


An address is an expression which when evaluateds provides an 
18 bit central memory address or a 24 bit ECS address. 


20424 CCOBG VARIABLES 


These variables are part of CCDBG and are available to the 
uS@fre They atl have identifiers beginning with #2. Ten user 
variables designated #Vl» #V2»x-e2es#V10 may be changed by the 
users The other variables may be accessed by the users but may 
not be changed. 


#BP Number of breakpoints currently defined. 

#TP Number of traps currently defined. 

#PR Number of debugger SCL procedures currently 
defined. 

RFL Central memory field tength. 

#?P Program address register. 

HERRCODE Reprieve error code. 


#CPUERR Mode error code. 


The following CCOBG variables may only be accessed when CCDBG 
is in interpret mode, 
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HINS Current instruction as number. 

#INSL Current instruction tength (15,5 30 or 60) 
#PARCEL Instruction parcel counter. | 
#0P OP code of current instruction. 

#1 i fieid of current instruction. 

#J Jj fietd of current instruction. 

HK k or K field of current instruction. 

#EA Effective address of current instruction. 
#EW Effective word. 

#PC Previous contents. 

HPA Previous addresse 


20%e5 EXPRESSION (CEXPR) 


<expr> *3:= (<operator>] <operand> (C<operator><oper and>lees 
<operator> 232 <4 <-—>D> 
<operand> 7232 <constant>i<namedi (<exprd) 


An expression is an algorithm for computing a value. 


a ed 


A comma or a space may be used to separate parameters or 
elements ina tist. 


204.7 COMMENTS 


<comment> 233 "<Casciid C<asciid].~..” 
Comments are not interpreted by CCDBG and serve only as 
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documentation. A comment acts syntactically the same as a space; 
ie2e.» whenever a space is allowed a comment is allowed» and 
whenever a space is required as a delimiter a comment will serve 
the same purposes 


20408 COMMAND 


<command> *:3= <command named ([<sep><param tist>] 


A command consists of the command =name followed by any 
parameters necessary to control its operation. 


20409 PARAMETER LISTS 


<param list> 23= <param> [<sep><param>]l eae 


A parameter fist consists of a series of parameters separated 
by spaces or commas. Each parameter in the list can be specified 
in one of three formats. The first format consists simply of the 
Parameter name. 


<param name> 


The second format cansists of the name followed by parameter 
text. 


€param name>d< = | <sp>> <param value> 


Both of the above formats are positionally independent3 1e@e» 


tha Aardaar in wth tanh thau em aan bal 
a ed * 22a gases © was te De F 


gre guoted is unimportante The thira 
format is positionally dependent and consists simply of parameter 
text. The positional significance of a parameter is one greater 
than the previous parameter specified in the lists Omission of a 
parameter can be indicated by two consecutive commas. 


we # 


<param value> 


204.10 VALUE LISTS 


<value fist> i:= (<value> C<sep><value>]...) 
A vatue list consists of a series of values separated by 
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spaces or commas and enclosed in parenthesese 
204211 CONTINUATION 


input lined 222 ¢text><..><EGL><text>d 


Commands can be continued by placing an ellipsis at the end of 
the line.» The first character of the continuation tine repiaces 
the first character of the ellipsis. The total number of 
characters must not exceed 150. Due to an implementation 
fanguage limitations the maximum length of a fine of tower case 
fetters (ASCII 6/12 format) is 120. 
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30 GENERAL DESCRIPTION OF _CCOBG_USE 


A CCDBG session must begin with a DEBUG(ON) control statement 
that places the operating system in CCDBG mode. It remains in 
CCD8G mode until the control statement DEBUG{(OFF) is entered. 
When the operating system is in CCDBG modes the CCDBG supervisory 
module is loaded as part of the system response to a request for 
the load of an abject program. Subsequent execution begins 
within the CCDBG modules not the user programs and the following 
message appears at the terminal: 


CYBIL-CC INTERACTIVE DEBUG 
? 


s 


The question mark is a prompting character issued by CCDBG 
each time it is waiting for a response From the terminal. 


Qnce the CCDB8G header line appearss the user should enter the 
CCDBG commands that would set breakpoints and trapss specify 
output optionss or preset any data valuese <A command of EXECUTE 
or GO starts execution of the object program, 


When any of the specified conditions occurs the condition is 
reporteds the execution is suspended», and control passes to the 
user at the terminal. Diagnostics and trap and breakpoint 
reports are displayed with a preceding asterisk. 


During the time the user has controls CCDBG commands can be 
antered ea waa mn AR RRR Re a ab wom aman nh FJ aw sem Foe mm aa + 
encerea oS GiSpray MI wey aw iscaticonss cnange avvwradtwttvuit Yai utes sys A wae 
additional breakpoints and traps» and generaliy expiore the 
behavior of the program. If necessarys the HELP command can be 


executed to learn about CCDBG commands. 


Program execution resumes at the location where it was 
suspendeds or at a user specified location. <Any abnormal program 
abort, as well as normal program terminations returns control to 
CCDBG. 


Debugging of a particular program ends when the QUIT command 
is entered. This command terminates CCDBG controts and other 
terminal operations can be performed. If any user program is 
subsequentiy referenced in a ftoad requests howevers CCDBG is 
again toaded and gains control. 
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CCOBG features are 
information about them. 


listed 


301 PROGRAM_EXECUTION CONTROL 


Program 
trap condition occurs. 


which it was interrupted or 


belows along with general 


execution haits whenever a user-defined breakpoint or 
Execution can be resumed at the point 


at 


at any other specified program 


focation within the same procedure, 


An interrupt command provides a general stop~on-demand 
capability that can terminate infinite loops or excessive 
output. 


3e2 CYBILACC SOURCE SYMBOL REFERENCE CAPABILITY 


Locations within a CYBIL-CC 


variable names and tine numbers 
the DEBUG option selected. 
using the same notation used 


notation). 
only if the subscript 
index. Variables and names used 
subscripts. 


Fields of records may 


Array elements may be referenced 


module can be referenced by 
if the module was compiled with 
be referenced 
CYBIL-CC (including pointer 
using a subscript 


in 


is a constant of the same type as the array 


as constants are not allowed as 


363 MACHINE LEVEL DEBUGGING FEATURES 


Program register values can 


Step mode execution by trapping each 


execution. 


Instruction-oriented 
interpret mode, 
operands» and 


trap 


the 


Each time execution stops» 
effective 


be examined and changed. 


instruction prior to 


cause execution in 
the is j and =k 
of the current 


definitions 


address 


instruction can be displayed. 


After awrite or read» 
value previously written 


the value can be displayed», 
or 


and the 


the prior contents of the X 
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register before a read can be displayed. The previous 
contents of the A register can also be displayed. 


30% QVERLAY_ ENVIRONMENT 


Program execution can be trapped when particular overlays are 
loaded. Detaiis of the overiay structure and of the toaded 
overlays can be indicated. An overfiay qualifier can be used in 
specifying an address or module name. 


3-5 DEBUGGER _ SCL PROCEDURE 


A debugger SCL procedure consists of a sequence of CCDBG 
commands and can be given a procedure names such that all 
commands in the sequence execute each time the procedure name is 
referenced, 


Similart ys a breakpoint or a trap can be defined with a CCDBG 


SCL procedure that executes each time the specified event 
occurs. 


3.6 CONDITIONAL COMMAND EXECUTION CAPABILITY 


A SKIPIF command within a debugger SCL procedure allows some 
CCOBG commands to execute only when particular program values or 
status variables exist. 


347 VETO_MQDE 


Veto mode gives the user veto power over each individual 
command within a debugger SCL procedure that is otherwise 
executing automatically. 


303 DEFINITION FILE CAPABILITY 


Definitions of trapss breakpointss and debugger SCL procedures 
can be saved on a fiie. This feature eliminates the need to 
re-enter long CCD38G sequences in future sessions. 
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309 CHECKPOINT/RESTART CAPABILITY 


A CCDBG session can be checkpointede. The session may tater be 
restarted with the CCDBG environment intact. 


3219 WARNING CAPABILITY 


A warning message is displayed prior to the execution of a 
command that would destroy existing definitionss or that might 
produce uncertain results. 


Zell CCD8G VARIABLES 


Special identifiers can reference CCDBG variables containing 
information such as current program address» field lengths number 
of breakpoints, traps or debugger SCL procedures defined. Ten 
scratchpad variables can be fully controlled by the user. 


3412 INFORMATLON OUTPUT 


Listings that can be obtained during a CCDBG session include: 


Load map information 
Current CCDBG environment 
Currently defined CCD8G SCL procedures 


A ont, es man diam ian . ee rennr mmm tem eo +3 nm ~ ae afm am dh om 
~~ any . @ 18 WMS Sag Lic VM WV? DSoCADs!A VIP LHS Usa ct wali WS CWL ad 
log of the remainder of the session to be written to a file for 


later printing. 


3413 HELP _COMMAND 


The HELP command can be used any time during a session to 
obtain a summary of information about CCDBG features. 
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4.0 CCD3G COMMANDS 


The following Sections describe the features of CCDBG 
commands» All CCODBG commands adhere to the System Command 
Language (SCL) definition as specified in the NOS/180 Preliminary 
ERS. The description of the parameters denotes the positional} 
order of the command parameters. 


4,1 BREAKPQINIS_AND_ TRAPS 


Breakpoints and traps provide a means for monitoring program 
execution. When a breakpoint tocation is reachedsy execution of 
the program is suspended» and CCDBG gains controi. For a traps 


CCDBG gains controi when some specific condition occurs. In 
either case CCDBG commands may be processeds allowing a 
programmer to look at and change elements of the executing 
programe 


Both traps and breakpoints may be established with "bodies", 
A body is a sequence of CCDBG commands that are executed 
automatically when the trap or breakpoint occurs. In this cases 
the user does not receive notification of the breakpoint or trap» 
nor does the user receive control unless a PAUSE command is 
executed as part of the body of the breakpoint or trap» 


The fact that a trap or breakpoint is being established with a 


ay A kaa bina af bh Pe te ee Cer Se AS 
sody is indicated by the presence sf the CGs1 Soe parameter on a 


SET_BREAKPOINT or SET_LTRAP command. All subsequent commands,» 
until a coliect lend is encountereds constitute the body. These 
commands are checked for syntax errors when they are entereds but 
they are not executed until the breakpoint or trap condition 
occurs. 


4.1.1 SETLBREAKPOINT 3 58 


This command sets a breakpoint in the userts program at a 
specified location. It may also start the definition of a cd 
(set of CCDBG commands between collect and collect_end). 
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set breakpoint Caddress_exopr] 


Cmodule=<namediloverlay=(<integer> 
s<integer>)] LCoffsetz<integer>d] 
[first=<integer>] Clast=<integer>] 
C[step=<integer>] [<collect><eoli3> 
C<command_statement><eol} s>J]eee 
<collect_end>] 


address_expr: The address specified by this parameter is known as 


module 


overlay 


offset 


first 


3 
4 


3 
4 


2 


the base address and may be specified in any of the 
following ways: 


line ${ !2<integer> 
Where integer is a CYBIL-CC fine number generated by 
the compiler. 


entrypoint { e=<name> 
Where name is an entry point identifier. 
NOTE: automatic variables and parameters are not 
available until the procedure profog is completed. 
This form is inctuded primarity for use with COMPASS 
entry points, 


Jocation i toc=<integer> 
where integer is an absolute address. 


If no keyword is specified in the order dependent 
Formats fine number will be assumed. 


mi CY31ItL-CC compilation unit to which line or label 
applies. If it is not specifieds the default module is. 
used. If address_expr is not specified» the base 
address is the beginning of the module, 


ovii This specifies the overlay number in which the 
breakpoint is to be set. Default is to use the toaded 
overlays in the following order? 1) overtay which is 
currently being executeds 2) main overlays 3) primary 
overlays 4) secondary overlay. 


o: A displacement which is added to the base address to 


form the effective memory address. Defauitt is zero. 


fi The number of times the breakpoint must be reached 
before it is honored. Default is 1. 


last: The breakpoint will not be honored again after it has been 


reached this number of times. Default is infinity. 
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4.0 CCDBG COMMANDS 
4.1.1 SET_BREAKPOINT ¢ SB 


step $ s? Frequency parameter. Breakpoint will be honored every 
step times it is reached. Default is 1. 


coliect $ c? Activates coidect node to establish a body for this 
breakpoint. 


command statement: CCD8G commands that make up the body of this 
breakpoint. 


collect_end : ce: Terminates collect mode. 


Upon establishment of a breakpoints a number is assigned. 
This breakpoint numbers #n»s is useful in referring to 
breakpoints» and is used in the breakpoint reporting message. 


When a breakpoint is reached and the frequency criteria are 
mets the breakpoint is honored. The message is? 


* B #n AT location 


where nis the breakpoint numbers and tocation defines the 
location as specified in the SET_LBREAKPOINT command. After 
issuing the nessages CCDBG is ready to accept new commands. 


Examples: $8 10 
Sets a breakpoint at tine 10 of the default module. 


SB ezsimplie offset=10 f=11 c¢c 
DR b243PA3cCe 


Sets a breakpoint 10 tftocations after entrypoint 
simple. it is honored the lith time it is reached» 
an naAaah - > mm thn mn nan Fe ne ‘i 2 a ; 4 nim & es 
cai’ va Coa wit %» AG B1IGI Cai LSI «@ wiicis Luss va CaAGnyuUadliL @2 
honored»s register B4 is displayed and a pause is 
donee 


4ele2 SETLTRAP $ ST 


This command establishes a trap.» It indicates the type of 
trap to be established and the scope of the trap. If the scope 
is not specified, the condition is trapped anywhere in the 
program. . ; 
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set_trap ¢; st type=<trap_type> [scope_exor] 
Coverlay=(<integer>s<integer>)] 
Cmodule=<name>] Cproc=<named 
Ce<namerd].».) Ctcollect><eoli;> 
[<command_statement><eoliz>r>lewe 
<collect_end>] 


type: Specifies condition which will cause interruption of 
program executions Trap_type must be one of the 
following. 


QVERLAY | OVL 
END 3: € 

ABORT 3 A 
INTERRUPT ¢ INT 
INSTRUCTION 3; I 


Con 
one 
= 
a”) 
ny 


NOTE: If trap_tyoe is OVERLAY or LINEs the keyword TYPE 
must be specifieds since OVERLAY» OVL and LINE are also 
used as Keywords in this command. 


scope_expr: This specifies where the trap is to apply. It is an 
address range which may be specified by any of the 
following? 


fine } 1=<integerdl<..><integer>d] 
Where integer is a CYBIL-CC line number generated by 


we wn [an 
Lic OvinpaiticTrs 


location i loc=<integer>(<..><integerd] 
Where integer is an absolute address. 


offset o=<integerd[<..><integer>] 
Where integer is an address relative to a module. 


variable { var=<name> 
Where name is the identifier of the variable. This 
form is used for READ and WRITE type trapse NOTE: 
Dynamic variables are assigned oniy when the proc in 
which they are declared is active. Traps on dynamic 
variables should not remain established after the 
procedure complietes. 
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If the order dependent format is used and a keyword is 
not givens line will be assumed. 


overlay ;: ovi: If trap_type is OVERLAYs this specifies which 
overlay number to trape For any trap_type other than 
overlay» it may be necessary to specify which overlay 
the address range applies to. Default és to use the 
loaded overlays in the following order? 1) overtay 
which is currently executings 2) main overitays 3) 
primary overlays 4) secondary overlay. 
NOTE? Overlay numbers default to decimal on input. 


module : mt CYBIL-CC compilation unit to which scope_expr 
applies. If it is not specifieds the default module is 
useds 


proc +: p: CYBIL-CC procedure name to which variabie applies. 
Nested procedures may be referenced in the format 


procl.~proc2.proc3,s where proc3 is the desired 
procedures If proc is not specifieds the default proc 
is used. 


collect : c: Activates collect mode to establish a body for this 
trape 


command statement: CCDBG commands that make up the body of this 
trap. - 


collect_end : ce: Terminates collect mode. 


Upon estabsishment of a traps a number is assigned. This trap 
number » Hn» is useful in referring to traps and is used in the 
trap messages A trap remains established for the remainder of 


mmawin Fin e | 
4 


3 4 a om m xd ~~ ~ 
anu ia a EuUci How wa we 


a ae rPrrnannt Pee ee sam § mm ve nn em ot 
, a od whe WOW = opm iwity . ai?rtconas Saiscwse 

When the condition specified in an establiished trap is 
encountereds trap action occurse The message to the user is: 


* T #n» type trap_message xx location 
Where n is the trap numbers, type is the trap _type specified in 
the SET_TRAP commands trap_message is additional information 
depending on types xx is AT or IN»y and location identifies where 
the trap occurred. After issuing the message» CCDBG is ready to 
accept new commands. 


Exampliess ST t=jump 1230..70 
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Sets a trap on jumps between tine 30 and tine 70. of 
the current default module. 


ST tewrite var=test_result 
Sets a trap on writes into variable test_result. 
ST TYPE = LINE 


This example afilows you to step through your program 
executing one line at a time, 


ST TYPE=LINE LINE=120..2140 COLLECT 
CV #VL #P-1 
DV #V1 F2ADR 
COLLECT_END 


This exampie sets atrap on the execution of any of 
the tines specified in the scope range (120-140)>s and 
displays the line number that was trapped. 


ST type=line c 
CV #vl #p-1 

DV #vl f=adr 
69 

ce 


This example creates a traces displaying each Jine 
number as it is executed. 


401.3 DISPLAY_BREAKPOINT : D8 


This command lists all breakpoints in a program (or part of a 
program) or if a specific breakpoint number or a specific 
focation is given the body of that breakpoint is displayed, 


display _breakpoint i db Caddress_expr] 
Cbh=<Xinteger>[<ee><integer>] : 
(<integer>{<..><integer>d] 
C<sep><integerd[ <..><integer>]]...)] 
CLoffset=<integer>] 
Coveriay=(<integer>s<integer>)] 
Cmodule=<name>] 


address_expr: Specifies the location or range of focations to 
display breakpoints from. It must be one of the 
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following: 


line +: Il=<Cintegerd{[<..><integer>] 
Where integer is a CYBIL-CC line number generated by 
the compiler. 


location i: loc=<integer>f{<..><integer>]) 
Where integer is an absolute address. 


entrypoint ; e=<name>d 
Where name is an entry point identifier. 


If the order dependent format is used and a keyword is 
not givens line will be assumed. 


b: The breakpoint number assigned when the breakpoint was 
established, 


offset :} o: A displacement that is added to the base address to 
form the effective memory address» Default is zero. 


overiay : ovis: This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the tloaded overlays in the following order? 1) 
overlay which is currently executing» 2) main overlays 
3) primary overlays %) secondary overlay. 


module  : om: The CYBIL-CC compitation unit to which the line or 
offset parameter applies. If module is not specifieds 
the default module is used, 
Examples: DB. 3 
Disolavs the bodv of breakonint numher 23, : 


DB overtay=(1,5s3) 


Lists all the breakpoints in overlay number (153). 
4ele4 DISPLAY_TRAP ! DT 


This command tists traps in all or part of the program; ors if 
a specific trap number or specific location is givens the body of 
that trap is tisted. If traps from a range of locations are 
being listeds the user may have all types of traps listed»s or may 
list only those traps of a specified type. 
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display trap 3: dt C{type=<trap_type>] ([scope_expr] 
Ct=<integer>([<.2.><integer>d] } 
(<integero(l<..><integer>d] 
C<sepr><integero>[<..><integer>Jle.e)] 
Covertay={<integer>»s<integer>)] 
{[module=<name>] Cproc=<name> 
Cet<namerd) 22] 


type? Specifies type of trap to be displayed. Trap_type must be 
one of the following? 


QDVERLAY 7+ OVL 
END i €E 

ABORT 3: A 
INTERRUPT ¢ INT 
INSTRUCTION {| Tf 
LINE 


Ley 
4 
~~ 
oe le 
Kania 


If no type is specifieds all types are displayed. 


NOTE: If trap_type is OVERLAY or LINEs the keyword TYPE 
must be specifieds since OVERLAY» OVL and LINE are also 
used as keywords in this command. 


scope_expr? Specifies the location or range of tocations to 
display traps frome. It must be one of the following: 


jine } F=<integer>(<es2<integer>) 


Lil, ma me A Faw em we mm owt 2 mm ee ee ee ee -) 
AINA & gyi LVoyos is a0) 0407 “CC 9S UC tun generat €u 


the compiler. 


or 
we! 


location } locz<Xintegerd[<..><integer>) 
Where integer is an absolute address. 


offset :. o=<integer>[<..><integer>d] 
Where integer is an address retative to a module. 


variable i var=<name>d 
Where name is the identifier of the variable. 


If the order dependent format is used and no keyword is 
given» line will oe assumed. 
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t: The trap number assigned when the trap was established. 


overlay } ovt: This parameter may be necessary to specify which 
overitay the address range applies toe Defauit is to 


use the loaded overlays in the following 
order: 1) overlay which is currently executings 2) 
main overtays 3) primary overlays 4) secondary 
overlay. 


NOTE: Overlay numbers default to decimal on input. 
module $} m: The CYBIL-CC compilation unit to which the line or 
offset parameter apolies. If it is not specifieds the 
default module is used. 
proc } ps: The CYBIL-CC procedure name to which variable applies. 
If not specifieds the default proc is used.» Nested 
procs may be referenced in the format 
procl.proc2.proac 3s, where proc3 is the desired 
procedures 
Exampies: OY m=my_mod 
Lists all traps of any type in module my_mod. 
OT type=rj 


Lists ail RJ traps set in the program. 
4.125 SAVE_BREAKPOINT 3} SAVEB 


This command saves the breakpoint definition on a local file 


2» 
Either specific breakpoints oF ati Greakpoints iH CHE Program oF 
part of the program may be savede If the breakpoint has a body» 
it will also be saved, If no quatifying parameters are 


specifieds ali breakpoints will be saved. 


save_breakpoint i saveb File=<name> [scope_expr] 
[b=<integer>[<.2.><integer>] ;} 
(<integerod(<..><integer>d] 
C<sep><integer>l<e»><integer>]1]o.2)) 
foffset=<integer>] 
Coverltay=(<integer>»s<integer>) ] 
[module=<name>] 


file 3 f: The name of a local file to write breakpoint 
definitions on.. 
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scope_expr: This specifies the ftocation or range of ftocations to 
save breakpoints fFroms It must be one of the 
following: 


fine !? l=<integer>{(<..><integer>] 
Where integer is a CYBIL-CC line number generated by 
the compiler. 


location : loc=<integer>([<..><integer>] 
Where integer is an absolute address. 


entrypotnt + e=<named . 
Where name is an entry point identifier. 


If the order dependent format is used and no keyword is 
givens line wil! be assumed. 


b: The breakpoint number assigned when the breakpoint was 
established. 


offset ! 0: A displacement that is added to the base address toa 
form tne effective memory addresse Default is zero. 


overlay i ovili This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the toaded overlays in the following order: 1) 
overlay which is currentiy executings 2) main overlays 
3) primary overlays 4) secondary overlay. 


module { mt: The CYS8IL-CC compilation unit to which tine or offset 


apply. If it is not specifieds the default module is 
used. 


Saves breakpoints number 2 and number 3 on focal file 
BPFILE. | 


SAVEBsbpsa9lO0ee40aa0( la 3) 9xyz12 


Saves on file BPS» all breakpoints in tines 10 to 40 
which are in module xyz12 on overlay {1 53). 
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4e1.6 SAVE_TRAP 3+ SAVET 


This command saves the trap definition on a tocal file. 
Either specific traps or all traps in the program or part of the 
program may be saved» Ali traps may be saveds or just one type 
of trap may be saved. If a trap has a bodys it will also be 
saved, If no trap numbers» types or scope_expr is specifieds all 
traps will be saved. 


save_trap i savet Filez<name>E type=<trap_typed] 
Cscope_expr] 
Ct=<integer>{(<..><integerd]) ; 
{(<integer>(<..><integer>] 
C<sepr><integer>({ <..><integer>]}]...)) 
LCovertay=(<integer>s<integer>)] 
Cmodule=<name>] [Cproc=<name> 
{ o<namer>j)e.s] 


File : f: The tocal file to write trap definitions toe 


type: Specifies the type of trap to be saved. Trap_type must be 
one of the following. 


OVERLAY ¢ OVL 
END 3 E 

ABORT 3 A 
INTERRUPT ¢: INT 
INSTRUCTION } I 
LINE 


Cin, 
c 
4 
2 Oo 
ah he 
FD Cw 


WRITE ? W 
If no type is specified», all types are saved. 
NOTE: If trap_type is OVERLAY or LINE» the keyword TYPE 
must be specifieds since OVERLAYs GVL and LINE are also 


used as Keywords in this command. 


scope_expr: This specifies the location or range of locations to 
save traps from. It must be one of the following: 


line : l=<integerd([<..><integer>] 
Where integer is a CYBIL-CC line number generated by 
the compiier. 
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location : toc=<integero>(<..><integer>] 
Where integer is an absolute address. 


offset i o=<integer>{<.e><integer>] 
Where integer is an address relative to the beginning 
of a module. 


variable $: var=<name> 
where name is the identifier of the variable. This 
form is used for READ and WRITE traps.» 


If the order dependent format is used and no keyword is 
gJivens line will be assumed. 


t? The trap number assigned when the trap was established. 


overlay : ovi: This parameter may be necessary to specify which 
overiay the address range applies toe Default is to 
use the loaded overtays in the following order: 1) 
overlay currentiy executings 2) main overlays 3) 
primary overlays 4) secondary overlay. 
NOTE: Overlay numbers default to decimal on input. 


module 3 ms The CYBIL-CC compilation unit to which the line or 
offset parameter applies. If it is not specifieds the 
default module is used. 


proc }; pi The CYBIL-CC procedure name to which var applies. If 


it is not specifieds the default proc is used, Nested 
procedures may be referenced in the format 
procl.eproc2seproc3,» where proc3 is the desired 


procedure, 


write 
Save aif traps of type write, 
SAVET module=i_test 


Saves all traps in module I_test. 
4.1.7 CLEAR BREAKPOINT : CB 


This command clears specific breakpoints, or all breakpoints 
in the program or part of the program. If no parameters are 
specifieds a warning message will be issued.» If the user accepts 
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the warnings all breakpoints will be cleared, 


clear_breakpoint : cb Cscope_expr] 
Cb=<integerd[<ee><integer>] i 
(<integer>(<..><integer>] 
C<sep><integer>(<..><integer>I])]...)3 
{foffset=<integer>d] 
Covertay=(<integer>»s<integer>) ] 
Cmodule=<name>] 


scope_expri This specifies the location or range of locations to 
clear breakpoints frome It must be one of the 
Following: 


line 3: 412<integerd[<..><integer>] 
Where integer is a CYBIL-CC tine number generated by 
the compiler. . 


location +: locz<Xintegerd>(<..><integer>] 
Where integer is an absolute address. 


entrypoint {| esz<name> 
Where name is an entry point identifier. 


If the order dependent format is used and no keyword is 
givens tine will be assumed. 


b3 The breakpoint number assigned when the breakpoint was 
established. 


offset i oa A displacement that is added to the base address to 
form the effective memory address» Oefault is zero, 


SvVGTiay + Gvit This parameter may be Aecessary TG sHEecify which 
overlay the address range applies to. Default is to 
use the loaded overlays in the foltowing order? 1) 
overtay currently executings 2) main overtays 3) 


primary overlays 4) secondary overlay. 
modufe $ ms. The CYBIL-CC compilation unit to which line or offset 
and proc apply. If it is not specifieds the default 
module is used. 
Examples: CB b=1 
Clears breakpoint number 1. 


CB ltine=17 of fset=4 
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Clears breakpoint at 4 words past the word containing 
the first instruction generated by the statement at 
line 17. 


4e1le¢8 CLEAR_TRAP : CT 


This command clears specified traps or afl traps in the 
program oor part of the program. All types of traps may be 
cleared or one type may be specified. If no parameters are 
specifieds a warning message will be issued. If the user accepts 
the warnings ali traps will be cleared, 


clear_trap : ct Ctype=<trap_type>iCscope_exopr] 
Ct=<integer>[<.e><integer>] | 
(<integer>{<..><integer>d] 
[<sepr<integerdl<..><integer>ll]e..)] 
Loverlay=(<integer>s<integer>d)] 
[module=<name>] {proc=<name> 
C.<name>jess] 


type: Specifies type of trap to be cleareds Trap_type must be 
one of the following. 


QVERLAY } OVL 
END 3 £E 

ABORT 3 A 
INTERRUPT 3} INT 
INSTRUCTION 3} I 
LINE 


7) 
vm 
> 
oo * 
inh oe aie 
AG Cu 


If no type is specifieds, all types are cleared. 

NOTE: If trap_type is OVERLAY or LINE» the keyword TYPE 
must be specifieds since OVERLAY» OVL and LINE are also 
used as keywords in this command. 


scope_expr: This specifies the location or range of locations to 
clear traps from. It must be one of the following: 


fine + I2<integerd[<..><integer>] | 
Where integer is a CYBIL-CC tine number generated by 
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4.0 CCDBG COMMANDS | ; 
4els8 CLEAR_TRAP ! CT 


the compiler. 


location 3; ioc=<integerr>(<..><integer>] 
Wnere integer is an absoiute address. 


offset + o=<integerd([<..><integer>] 
Where integer is an address relative to a module, 


variable 3: varz=<€name> 
Where name is the identifier of the variable. This 
Form is used for READ and WRITE type traps. 


If the order dependent format is used and no keyword is 
givens line will be assumed. 


t: The trap number assigned when the trap was estabtished. 


overlay i: ovii This parameter may be necessary to specify which 


averiay the address range applies to. Default is to 
use the loaded overlays in the following order: 1) 
overiay currentiy executings, 2) main overiays 3) 


primary overlays 4) secondary overlay. 
NOTE: Overlay numbers default to decimal on input. 


module i m: The CYBIL-CC compitation unit to which the tines 
offsets or proc parameter appliess If it is not 
specified» the default module is used. 

proc i p? The CYBIL-CC procedure name to which variable applies. 
If it is not specifieds the default oroc is used. 
Nested procs may be referenced in the format 
proclseproc2seproc3,s where proc3 is the desired 
procedure. . 

Examples; CT typezoverlay 
Clears ali traps of type overlay in the program. 

CT teinstruction. toc2=1653(8)..170018) 


Clears any traps of type INSTRUCTION in the address 
range 1653 to 1700. 
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4.1.9 SETLINTERPRET : STI 


Allows the CCDBG user to explicitly control the use of 
interpret mode. Interoret mode is turned on by the SET_LINTERPRET 
command. 


Interpret mode is aiso turned on when any trap of types Rid» 
XJ» JUMP» WRITE» READs or INSTRUCTION are established. 


If a CLEAR_INTERPRET command is subsequently issueds the traps 
are made inoperative until a2 SI command is issueds when they 
again become operative. 


4,110 CLEAR_INTERPRET : CI 
Clears interpret mode. 


4.2 DISPLAYING AND CHANGING PROGRAM VARIABLES 


4.2.21 DISPLAY_VARIABLE : DV 


This command displays the values of CYBIL-CC identifiers in a 
format corresponding to their program defined types or in a 
memory format specified by the usere Fields of records may be 
referenced using the same notation used in CYBIL-CC including 
pointer notation). Array elements may be referenced using a 
SubSGript oniy if the subscript is a constant of the same type as 
the array index. Variabtes are not allowed as subscripts. 


display variable : dv Cvar=<name>] 
{formatzoct { dec $ hexl€modutes=<named] 
Cprocz<name>] [e<name>]...] 


variable + var: Name of the program variable to display. It will 
be disptayed ina format corresponding to its program 
defined type. These types and corresponding formats 


are? 
integer - signed decimai integer 
character - ascii character enciosed in single 
quotes. 
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format 3 


ordinal - name composed of ascii characters 
boolean —- true or false 
pointer - octal digits 

set - each element is displayed as listed aboves 


depending on its defined type. 

string - ascii characters enclosed in single 
quotes 

sequence - octal digits 

array —- each item is displayed as above,» 
depending on its defined type. 

record - each fieid is displayed as above 
deoending on its defined type. 


If no variable name is specifieds a list of variables 
will be displayed. What variables are displayed 
depends upon which other parameters are specified. If 
var is not svecifieds and proc iss then all variables 
focal to the specified proc are displayed. If only 
module is specified then onty variables at the module 
level are displayed. If no parameters are specifieds. 
local symbols for the current default are displayed. 
This may be either procedure tlevel or module level. 
depending on the current default vaiue. 


fi Specifies the format in which to display the 
variable. One of these three: 


oct: Octal digits followed by (8) 
dec: Signed decimal integer 
hex: Hexadecimal digits followed by (16) 


If this parameter is specifieds it overides the program 
defined type format. 


module + m? The CYBIL-CC compilation unit to which var applies. 


proc 3; 


Example: 


If it is not specifieds the default module is used. 


pe? The CYBIL-CC procedure name to which var applies. If 


it is not specifieds the default proc is used. Nested 
procedures may be referenced in the format 
procl.aproc2.proc3, where proc3 is the desired 
procedure. 


OV var=i procecalculate_subscript 
Displays variable I in format corresponding to its 
program defined type, Variable I is in proc 


calculate_subscript. 
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4.2.2 CHANGE_VARIABLE | CV 


This command changes the memory ftocations at the address of 
the CYBIL-CC identifier. Subscripted references and field 
references may be made in the same way as in DISPLAY_VARIABLE. 


change_variabie {: cv varz=<name> value=<expr> 
Cmodule=<name>] (Cproc=<name> 
C.<namerJ]e.es] 


variabie * var: Name of the user variable to change. 


value ;: vi The decimal» octal or ascii value to be stored at the 
specified variable. The Format of the value must match 


the type of the variable {see list under 
Disolay_Variabie). For boolean variables,» onty the 
values ‘'true' and ‘tfalset are valid. For ae set 


variables the vaiue specifies an etement of the set 
that is to be added to or deleted from the set. 


module ; ms: The CYBIL-CC compilation unit to which var applies. 
If it is not specified» the default module is used. 


proc : p?: The CYBIL-CC procedure name to which var applies. If 
it is not specifieds, the default proc is used. Nested 
procedures may be referenced in the format 
procl.proc2.proc3,s where proc3 is the desired 
procedure. 


Example: CV var=x_string value='zero? 


tring zero. x_ string 


* aT” 


4o3 DISPLAYING AND CHANGING MEMORY AND REGISTERS 


The DISPLAY_MEMORY,»s FORWARD and BACKWARD commands maintain a 
Single default memory address and a default format. After being 
set by a DM commands these values are used by FORWARD and 
BACKWARD.» This allows other commands to be used between = any 
memory display commands without losing the position or format of 
the memory being displayed. The memory address and format are 
updated by each FORWARD». BACKWARD or DM command. Specifying a 
Format type on a FORWARD or BACKWARD command means that format 
will be the default until a new format is specified. 
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4.321 DISPLAY_MEMORY + DM 


This command displays the contents of a specified number of 
words beginning at a specified address.» 


display_memory ¢$ dm <address_expr> 
Cformatzoct : dec +: adr : hex] 
Cnumlocs=<integer>] 
Coffset=<integer>Il[module=<named] 
Cindirect] 


address_expr: The address specified by this parameter is known as 
the base addresses <Any one of the following forms may 
be used. 


Tocation ! loc=<integer> 
Where integer is an absolute address. 


fine i l=<integer> 
Where integer is a CYBIL-CC tine number generated by 
the compiler. 


ecs = <integer>d . 
Where integer is an ECS address. 


entrypoint : e=<name> | 
Where name is an entry point identifier. 


If the order dependent format is used and no keyword is 
givens tocation will be assumed. 


format 3 f: Format of the memory display. It must be one of the 
Foatlowing. 


oct: Octal digits followed by (8) 

dec: Signed decimal integer 

adr: Lower 18 bits are displayed as an address 
hex: Hexadecimal digits followed by (16) 
Default format is oct. 


numiocs { nt This specifies the number of memory tocations to be 
referenced. Defauit is one, 


offset { 0: A displacement which is added to the base address to 
form the effective memory address.» Default is zero. 
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module ! m3 CYBIL-CC compilation unit to which tine or offset 
applies, If it is not specified» the default module is 
usede 


indirect : i: This specifies that the display is to be at the 
memory location addressed by the contents of the base 
address. 


Example? OM e=cdtasoffset=4»sf=octsn=10 


Displays ten words of memory in octal digits beginning 
four words after entrypoint cdta» 


42322 FORWARD ¢ FW 


This command continues the memory disptay forward from the 
Jast DMs FORWARD or BACKWARD command. Displays memory starting 
with the word following the last word displayed by the previous 
commande 


forward 3: fw numlocs=<integer> 
Cformatzoct ! dec 3} adr !} hex] 


numfiocs : ni Specifies the number of memory tocations to be 
referenced, 


format : f: Format of the memory display. It must be one of the 
following: 


oct: Octal digits followed by (8) 

dec: Signed decimal integer 

adri Dispiays tower 15 bits as an address 
hex: Hexadecimal digits followed by (16) 


Default value for format is to continue in the same 
Format as the previous display memorys forwards or 
backward commande 

Exampie? FORWARD 6 


Displays the next 6 words of memory in the same format 
as the previous DISPLAY_MEMORY»s FORWARD or BACKWARD. 
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4.3.3 BACKWARD : BW 


This command continues the memory display with the section of 
memory preceding the current display memory § tfocation.e Tt 
dispiays memory from the word preceding the first word displayed 
by the previous command back n locations. 


backward 3: bw numfiocs=<integer> 
Cformatzoct $ dec ? adr ¢ hex) 


Nnumiocs ; n?3 Specifies the number of memory tocations to be 
referenced. : 


Format ; f:. Format of the memory display. It must be one of the 
Following? 


oct? Octal digits Followed by (8) 

dec: Signed decimal integer 

adr: Displays tower 18 bits as an address 
hex: Hexadecimal digits followed by (16) 


Defauit value for format is to continue in the same 
format as the previous display _memor yy» forwards or 
backward command. 


Exampie: BACKWARD 4soact 
Displays the four preceding words of memory in octal 
format. . . 
4.304 CHANGE_MEMORY 3 CM 
This command changes the contents of the specified memory 
locations. 
change_memory { cm <address_expr> 
[module=<name>] [Coffset=<integer>] 
value=<exprd> Cnumlocs=<integer>] 
CLindirect] 
address_expr: The address specified by this parameter is known as 
the base address. Any one of the following forms may 
be used. 


location 3 loc=<Xinteger> 
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44324 CHANGE_MEMORY : CM 


Where integer is an absolute address. 


line i t=<integer> 
Where integer is a CYBIL-CC line number generated by 
the compiler. 


entrypoint ; e=<named> 
Where name is an entry point identifier. 


ecs = <integer>d 
Where integer is an ECS address. 


If the order dependent format is used and no keyword is 
givens tocation is assumed, 


module ${ mi The CYBIL-CC compilation unit to which tine applies. 


offset $: 03 A displacement which is added to the base address to 
form the effective memory address. Oefauit is zero, 


value ! vi: The octals decimals hexadecimal or ascii value which 
is to be stored at the memory address specified. 


numiocs i nt This specifies the number of memory tocations to be 
changed. Default is ones 


indirect ! i: This specifies that the focation to be changed is 
the memory location addressed by the contents of the 
base address. 

Example: CM 10¢75270(3) v=1493 


1493 (note default base is decimal) in octal 
5270+ 


4.325 DISPLAY_REGISTERS 3§$ OR 


This command displays the contents of the machine registers. 


display registers i? dr Cp 3}; fl ¢ Ca 3 bY x={<integer>d1]] 
e 


Cformat=oct : dec $: adr } hex] 
Lindirect] 


p : f1 $ a i bd? x3 This specifies which type of register is to 
be displayed. The number for as by» or x» indicates 
which register number to display. If no register 
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number is specifieds, ali of the specified type will be 
displayed. If the parameter is omitteds all 24 As By 
and X registers will be displayed. 


format : f2 Format of the register display.» It must be one of 
the following: . 


oct: Octal digits followed by (8) 

dec: Signed decimal integer 

adr: Displays the lower 18 bits as an address 
nex? Hexadecimal digits followed by (16) 


Defauit value of format is octal for as bs and x 
registerss and address for p and fl registers. 


indirect ?. i: This specifiess if quoteds that the display is to 
be at the memory location addressed by the contents of 
the register. 

Example: DR b 


Dispiays ali b registers in octal format. 
42346 CHANGE_REGISTERS 3} CR 
This command changes the contents of the machine registers. 


change_registers i cr ai bi x=<¢integer> 
value=<exor> Cindirect] 


a; bi x? This specifies which type of register is to 
mhaanananad Tha re a. ae ~~ mee smo eh an a ae ear ara ~_ a es ha 
wid youe 11IS FFF RSCYCS ayryoCVwlt@ Crd Lic F CyIDE SC! iwWumUe sy Lv 
be changeds 


value 3 vi This is the octals decimals, hexadecimal or ascii vatue 
to be stored in the register. 


indirect :. i: This specifiess if quoteds that the value is to be 
stored at the memory fiocation addressed by the contents 
of the register. 

Example: CR x26 v=1236(8) 


Places the value 1236 (octal) in register x6. 
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4.4 DEBUGGER SCL PROCEDURES 


A debugger SCL procedure is a named sequence of CCDBG commands 
that is established within the CCDBG environment. Any desired 
CCDBG command sequence can be established as a debuger SCL 
procedures Procedures can be invoked either from within some 
other procedure or from the terminal when in interactive command 
input modes by issuing a READ command referencing the name of the 
defined procedure. 


4e4e1 SET_PROCEDURE : SP 


This command establishes a debugger SCL procedure. 


set procedure ! sp procedure=<name> (<cotiect><eol} 53> 
C<command_statement><eoli3>]...] 
<collect_end> 


procedure i pr: The identifier assigned to this sequence of CCDBG 
commands. 


collect i. c: Activates collect mode, This parameter is not 
necessary to establish a procedures but is inciuded in 
the syntax for compatibility with SET_TRAP and 
SET _BREAKPOINT commands. 


command_statements: CCD8G commands which make up the body of the 
procedure. They are checked §£=for syntax but not 
executed at this time. 


Pies 


an k ain Tht eo ee 2. 
cwh WwuUuce 4 


a ~ om 8 a. mw me 
Ci Wa UaALGys wis a ?w'>s> Pa ancecccy asa 


Example: SET_LPROCEDURE procedure=newid; DR b=53 DV var=x3dv y3 
PA; ce 
Creates a procedure named newid which contains several 
commands.» ; 
40422 DISPLAY_PROCEDURE | ODP 
This command displays the commands that make up the specified 
procedure. If no procedure identifier is specifieds the names of 
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afl existing debugger SCL procedures are displayed. 


display_procedure i dp [procedure=Cname> } 
(<namer(<sep><named]..+)] 


procedure : prt The identifier of the procedure to be displayeds 
as specified in the SET_PROCEDURE command. 


Examples DP proceduresnewid 


Displays the debugger SCL procedure named newid. 
42423 SAVE_PROCEDURE 3 SAVEP 


This command copies specified procedure definitions to a tocal 
file. If no procedures are specifieds ali debugger SCL 
procedures are copied to the file. 


Save_procedure !{ savep file=<name> Lprocedure=<name> } 
{<namer>E<sepr<namerd].22)] 


file ; fF: The name of the file the procedure is to be saved one 
procedure i or: The identifier of the group to be saved. 
Exampfe: SAVEP procedure=newid f=saveid 


Saves procedure named newid on file saveid. 
40404 CLEAR PROCEDURE 3 CP 


This command removes specified debugger SCL procedure 
definitions. If no procedure is specified» a warning message is 
issueds and if the user accepts the warnings all debugger SCL 
procedures are cleared, 


ciear_procedure + cp Cprocedure=<Cname> ; 
(<namer>(€ <sep><namerdje22)] 


procedure jj; pr: The identifier of the procedure to clears as 
specified on the SET_PROCEDURE command. 


Example: CP procedure=newid 
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Ciears debugger SCL procedure newide 


45 DEBUGGER SCL PROCEDURE COMMANDS 


A procedure is a set of CCDBG commands established as a 
debugger SCL procedures Qnce initiateds the commands in a 
procedure execute automatically. 


Any CCD8G command may be used in a procedure, Most of the 
following commands» however, are particularly designed for use in 
a proceduree 


4e5e1 PAUSE i PA 


This command temporarily suspends the automatic execution of 
the current CCDBG procedure and enters interactive modes allowing 
CCDBSG commands to be entered from the terminal. 


On the occurrence of the first PAUSE command in aie procedure 
body of a trap or breakpoints the appropriate trap or breakpoint 
report is issued prior to entering interactive mode, 
pause i pa Ctext='€<asciidJ]...!] 
text ! t? Message text to be issued when pause is executed, The 

text may be any string of characters. It is delimited 
by a pair of apostrophes (!). Apostrophes within the 
text are indicated by two consecutive occurrences of 
the character. 


Examples: PAUSE text='x3 is new value of I! 
4.502 MESSAGE { ME 
This command issues a designated message to the users terminal 

during a procedure executione 

message i me Ctext=!€<asciid]...'] 

text 3 t: Message text to be issued when the command is 
executed. The text may be any string of characters. 
Tt is delimited by a ovpair of apostrophes {('),. 
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Apostrophes within the text are indicated by two 
consecutive occurrences of the character, 


Example: MESSAGE 'Variable XYZ has been modified? 
4.5.3 60 


This command causes an exit from the current debugger SCL 
procedure or interactive mode and aeresumption of suspended 
processing. The current debugger SCL procedure may have been 
invoked by a reads in which case the processing wil! be resumed 
with the statement following the read. 


If the G60 command is issued from a breakpoint or trap body» 
program execution is resumed. In this fast cases GO is identical 
to the Execute command. Resumption of program execution can be 
specified via the optional address parameter. 

go Caddress_exprlifoffset2=<integer>] 
address_expr: Address at which execution is to resumee It is not 
possible to resume execution in a different module or 
procedure. Address expr may be any of the following: 
line { 1l=<integer> 
Where integer is the CYBIL-CC line number generated 
by the compiler. 
fjocation ! toc=<integer> 
Where integer is an absolute address» 


ame 
entry point identifier. 


If no keyword is given for address_exprs line will be 
assumed, 


offset {| o% A displacement added to the base address specified by 
address_exprs 


Example: 60 Jline=42 offset2=3 
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40504 SKIPIF 3 S$ 


This command conditionaliy skips the following command when 


the specified relation is satisfied. 


skipif i s <value_1><relation><value_2> 


value_1l ivils An integer expression. It may include CCDBG 


variables,s but not program variables. 


relation: One of the following? 


= Equal 
<> Not equal 
< Less than 
<= Less than or equal 
>= Greater than or equal 
> Greater than 
value_2 ! v2: An integer expression. It may iInctude CCDBG 


Variabiless»s but not program variables. 


Example: SKIPIF #V1 < 20 


Skips next command if the vatue of CCDBG variable #V1 


is tess than 20. 
4.525 LABEL } LA 


is command def 


dura whara it ia 
wh ee Ya ig wf we , ad 


nes an identifier for the location in 
Labels are tocal to the procedure in which they occurs 

check is made for duplicate ltlabelis. 

Jjabel i la name=Cname> 

name i: ni: Identifier to be used for this location. 

Example? LABEL n=b1013— | 


Establishes tabel B1OL3 at the current location in 
proceduree 


the 


No 


the 
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4.526 GOTO 


This command transfers control to the specified labet within a 
procedures Control can be transferred either Forwards or 
backwards. Search is forwards end arounds until the first 
occurrence of the label is found. 
goto label=<name> 


jabel ; la? Identifier of location to which control is 
transferred. 


Examples G0T0 b1013 


Transfers control to the location of ftabel B1O0L3 
42527 READ | R 


This command is used in three different ways: 


1) To process CCD3BG commands stored or modified by some facility 
not provided by CCOBG itself (e.g.9 the editor). 


2) To reconstitute breakpoints traps and debugger SCL procedure 
definitions previousiy SAVEd on a file. 


3) To invoke a debugger SCL procedure, 

read ir | file ! procedure = <name> 

File ! Fs Nama of File containing commands ts be executed. 
procedure } pri Name of procedure to be executede 


Exampdes: READ febpfile 


Re-establishes Dreakpoint definitions saved on 
BPFILE. 


READ procedure=newnid 


Initiates processing of procedure NEWID. 
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406 ADDITIONAL _INTERACTIVE MODE COMMANDS 


4.621 EXECUTE ¢: EX 


This command starts or resumes program execution.e. Program 
execution is initiated at the next instructions or at the user 
specified address. This command differs from the GO command when 
there are higher levels of CCDBG commands. G0 transfers control 
to the next higher tevel of CCDBG commandss EXECUTE bypasses all 
CCDBG commands to resume program execution. 


execute { ex Caddress_expr] [CLoffset=<integer>] 


address_expr: An address at which execution is to resumes I[t is 
not possible to resume execution in another module or 
procedures It may be any of the following? 


line ¢: l=<integer> 
Where integer is the CYBIL-CC line number generated 
by the compiler. 


location : loc=<integer> 
Where integer is an absolute address. 


entrypoint i e8 = <name> 
Where name is an entry point identifier. 


If no keyword is given for address_exprs line will be 
assumed, 


me 
43 


ta ee eee _ = FN BPS oe Shs on ah ee ae adden BD hme bie he ee ae eee 
Le] sel is Vs A UIdSVE AGCKHeMNL AUGeEU LY LHS Vast aU CSS 


Example: EX 146 
Resume execution at line 146 relative to the current 
executing module. 


4.6.2 TRACEBACK i: TB 


This command produces a Jtist of CYBIL-CC procedure names» 
beginning with the currentiy executing CYBIL-CC procedure and 
moving backward througn successive levels. 
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traceback ; tb Centrypoint=<named] 
entrypoint 3 e? If aenon-CYBIL-Cc routine has multiplie 
entrypointsys this parameter specifies at which 


entrypoint to start the traceback. 
Examples TB 


Lists all calis beginning with the most recent = and 
going backward as far as possible. 


426.3 MOVE 3: M 


This command moves values from one address range to some other 
address range or location» The action taken depends on whether 
either the source or destination parameter is a range 
specification, 


If the source or destination is a range specifications the 
numlocs parameter is ignored even if present and enough words are 
moved from the source to fill the destination range. If the 
source range is smaller than the destination ranges the words are 
moved repeatediy until the destination range is filled. If the 
Source range is largers oniy as many words as are needed are 
moved» 


If neither the source nor destination is a range 
specifications the numlocs parameter determines the number of 
words to move, 


move i m7 source_expr de 
ka 
an 


Tansaimd Pw, ae ~ 
LiiwWwit VwYonmr Ne 


tination_expr 
nen 4 
wir J 
source_expr: Address or address range expression from which to 
move valuese Must have one of the following forms: 
source_line {} si=<integer>(<..><integer>] 
Where integer is a CYBIL-CC line number generated by 


the compiler. 


source_offset i so=<integerd{(<..><integer>]. 
Where integer is an address relative to a module. 


source_laocation ; stoc=<integer>([<se><integer>] 
Where integer is an absolute address. 
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If a keyword is not specifieds source_location is 
assumed. 


destination_expr: Address or address range expression to which 
values are to be moved. Must have one of the Following 
forms? 
destination_line 3; di=<Xinteger>[<..><integer>] 
Where integer is a CYBIL-CC !ine number generated oby 
the compiler. 


destination_offset *! do=<integer>d[<..><integer>] 
Where integer is an address relative to a module. 


destination_focation : dloc=<integer>[<..><integer>] 
Where integer is an absotute address. 


If a keyword is not specifiedsy destination_location is 
assumed. 


numilocs $ ni Number of words to be moved if neither the source 
nor the destination is an address range». Default ts 
Ones 

Example: MOVE sfoc=112(8)..2120(8) dioc=142(8)..150(8) 
Moves 7 words beginning at 11l2{(octal) to a 7 word fietd 


beginning at tlocation 142 octal)» all addresses are 
absolute. 


42604 HELP { H 


This command can provide immediate assistance to a terminal 
user about CCDBG features. It acts as a selectively accessed 
on-line information summary.e 
heip i h C<subject> $ <command_ named] 
<subject>: Gne of the permissible subject categories. 
<command_ name>: A CCDBG command identifier or abbreviation. 

If no parameter is specifieds the subject index is listed. 


This displays all the permissible subject catagories that may be 
entered as parameters to help. 
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Example: HELP cmds (lists af! CCD8G command identifiers) 
42625 SAVE_ALL ¢ SAVEA 
This command saves all traps breakpoint and debugger SCL 
procedure definitions. 
save_all : savea fFile=<name> 


file 3 fi The name of ae tocal file on which to save the 
environment. 


Example: SAVEAsbigfile 


This command ailows a user to save the CCDBG information 
necessary to return to the debug session at a later time. 


CHECKPOINT saves the current CCDBG environment (breakpoint»s 
traps and debugger SCL procedure definitions)» and current status 
(interpret and veto mode settings)» output options, default 
modules default procs CCDBG variables and tabiess and the user 
program images ona file, 


Restoration of CCDBG to its statuss environments and user 


program image is done by issuing the system command DEBUG(RESUME, 
filename). 


a : i] 3 a. a. a™ 
checkpoint $ ck | file=etname> 


file : f: The name of a focal file on which the CCDBG environment 
wifi be saved, 
Example: CHECKPOINT Ffesf 


4e6.7 QUIT 


Tais command terminates a CCDBG session, 


quit {normal : abort] 


COMPANY PRIVATE 


4-34 
CDC — ADVANCED SYSTEMS DEVELOPMENT 
09/29/80 
ERS for CYBIL-CC Interactive Debugger | Pee see REV? D 
4.20 CCDBS COMMANDS 
4.6.7 QUIT 


normal: Terminate normally.» This is the default if no parameter 
is specified, 


abort: Causes an abort type of termination to occur. This allows 
abort processing if CCDBG is being used in a batch job» 
or from a procedure file, 


4.7 CCDBG ENVIRONMENT COMMANDS 


4,701 SET_LVETO 3: SVE 


This command provides a method of CCDBG sequence operation 
that combines the automatic and interactive modes. When veto 
mode is ons each command in a CCDBG sequence is displayed before 
it is executed. The user is given temporary control at this 
pointe. The user may allow the command to be executeds skip ity» 
or repiace it with one or more new commands. 


set_veto i sve 
4e.7e62 CLEAR_VETOQ ; CVE 
This command terminates veto mode, 
4.723 SET_DUTPUT : $92 
This command altows the user to contro! the kinds of CCDBG 
output that are written to the standard output File. 
set_output i so lo=<options> 
flo: List optionss any of the following: 
Error messages 
Warning messages 
Debug output produced by command execution 
Informative messages . 
Read command sequence (group or file) when read 


Body sequence when it occurs (trap or breakpoint) 
Terminal or standard input file echo 


res ae Oe Db 
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The default options when the list is omitted are 
Q@eswedsir If e is omitteds an auxiliary file must be 
defined with the e option specified, 


Example: $0 to=leswsi) 
472% SET_LAUXILIARY $ SAUX 


This command allows a user to define an optional auxiliary 
output file and controi the kinds of output that are written to 
it. 


set_auxiliary i sau x file=<name> lo=z<options> 
file ! f2 Name of the file to be the auxiliary output file. 


lo: List options. These define what is to go on the file. Any 
of the following: 


Error messages 

Warning messages 

Debug output produced by command execution 
Informative messages 

Read command sequence (group or file) when read 
Body sequence when it occurs (trap or breakpoint) 
Terninal or standard input file echo 


ToS = Oo ZO 


Example: SAUX f=pxidaux lo=(doer) 
4.7.25 CLEAR_AUXILIARY ¢ CAUX 


Closes the current auxiliary file and clears ait the auxiliary 
options. 


40706 DISPLAY_MAP 3 DMAP 


This command displays load map information relating to modules 
entry points, and overlays. 
disptay_map 3; dmap (module=<name>d] 
Cfoverlay=(<integer>s<integer>)] 
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module } ms A CYBIL-CC compilation unit. If a moduite is 
specifieds, its origins tength and all entry points 
contained in it are displayed. 


overtay : ovis: If an overtay is specifieds the names. of all 
modules in the overtay are listed. 


If no parameter is specified in a non_overlay environments the 
names of ali modules are tisted,. In an overtay environments 
designations of overlays are listed. 


Example: DMAP mz=adapt 


Displtays toader information about module adapt. 
4.727 DISPLAY_DEFAULTS ? DD 


This command displays the current default value for modufie and 
proce 


4728 DISPLAY_STATUS 3: DS 


This command dispiays information to help the user determine 
the current state of the debug session. 


display _status i ds 


The following information is displayed, 


The ftsocation cf the trap or breakpoint currentiy 
honoreds or the tocation of user program abort or 
interrupt to be displayed. 


The overiay numbers currently in core and their 
addressesSe 


The current terminai output options. 


The name of the current auxiliary output file and the 
current auxiliary output options. 


The current state of veto mode (on or off). 
The current state of interpret mode (on or off). 
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The number of breakpointss traps»s and groups currently 
defined. 


4.729 CHANGE_DEFAULTS ; CD 
This command allows the user to change the default values of 
module and proc to new identifiers. 
change_defauits : cd [modulez<name>] 
Cproc=<name>] [<.named]...] 


Cfoverlay=(<integer>s<integer>)]) 


module i m: This parameter changes the default module from the 
specified module, 


proc ; p3 This parameter changes the default proc to the 
specified proc. 


overiay +: ovi? Overlay which contains the new default module or 
proce 


Exampie? CD m=zcimtay 


Changes default module to the modute with atias 
zelmtaye 


oa 
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Deol DIAGNOSTIC MESSAGES 


Diagnostic messages issued by CCD8G are listed below. These 
messages are issues in one of the following forms: 


¥*¥ERROR - message text 
? 


*CMD - (command text) ERROR - message text 
9 


s 


When in collect modes some errorss such as those involving 
invalid Syntax» are detected and reported prior to being 
collecteds thus allowing them to be corrected at that time. 
Other errors are not detected until execution of the command is 
attempted. 


Message Significance and Action 

ADDRESS IN GO or EXECUTE has been supplied with a location 

ECS/LCM parameter that is an ECS or LOM address. If sup- 
plieds the address must be one in central memory. 
ACTION? Correct and reenter. 

ADDRESS IN A specified symbolic address implies one contained 

UNLGADED in an overlay not currently toaded, 

QVERLAY 


ACTION: Confine symbolic addresses to those in 
currently loaded overlays. 


ADDRESS An address reference is to a location in DBUG» 

QUTSIDE beyond the first 1008 (approximately) locations, 

USER AREA or beyond the user field tength. These tlocations 
are inaccessible to the user. 


ACTION: Reenter with an allowable address. 
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BAD INDEX Internal error. 
TYPE ji 
ACTION: Submit PSR. 
BAD A variable of tyoe ordinal contains an 
DRDINAL undefined value. 
VALUE ji 
ACTION: None. 
BAD SYMBOL Internal error. 
TYPE ji 
ACTION: Submit PSR 
CANNOT The CHANGE _VARIABLE command can only change the 
CHANGE value of simple variabless such as fields of 
VALUE OF records or elements of arrays» 
ENTIRE 
RECORD OR 
ARRAY 
ACTION: Reenter with subscript or field notation. 
CANNOT Internal error. 
EVALUATE 
VARIABLE. 
TYPE ji 
ACTION: Submit PSR. 
DEBUG An error in Debug is preventing further pro- 
INTERNAL cessing. Debug must be aborted. The program 
ERROR being debugged could have damaged a portion of DBUG. 
ACTION: Try a new Debug session with all execution 
performed in interpret modes which protects 
O8UG. esode. 
ERROR Completing the current SET DUTPUTs SET 
MESSAGES AUXILIARYs CLEAR OUTPUT» or CLEAR 
MAY NOT BE AUXILIARY command results in no file being 
SUPPRESSED designated to receive error messages. 


ACTION: Assign file options consistent with this 


restriction. 
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EXECUTION The address specified is outside the current 
ADDRESS procedures and execution of the command would 
OUTSIDE invalidate the stacke 
CURRENT 
PROCEDURE 
ACTION: Correct and reenter. 
INVALIO An illegal descriptor word was found for 
DESCRIPTOR an adaptable array. 
WORD FOR 
ADAPTABLE 
ARRAY 
ACTION: Use a write trap on the pointer to find the 
point where the descriptor is destroyed. 
INVALID A breakpoint has been supplied with an invalid 
FIRST» frequency parameter, 
LAST OR 
STEP VALUE 
ACTION: Check that all such parameters are 
positive. Check that LAST is not tess than 
FIRST.» Reenter with corrected values. 
First is timited to 2629143. Step is 
limited to 4095. 
INVALID The vaiue input is not a valid value for this 
ORDINAL variable. 
VALUE x 
ACTION: Correct value and reenter. 
INVALID The supplied HELP parameter is invatid. 
PARAMETER . 
XXX 
ACTION: Enter HELP for a fist of valid parameters: 
Reenter the HELP command with a valid 
parameter. 
INVALID Value type for a variable or subscript 
VALUE does not match the value input. 
SPECIFIED 
FOR 
VARTABLE 
OF TYPE x 


ACTION: Verify variabie type and reenter in proper 


format. 
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INTERNAL Internal error. 
ERROR - 
STACK 
UNDERFLOW 
ACTION: Submit PSR. 
INTERNAL Too many tevels of record and array declarations 
ERROR - exist in the variabie to allow CCDBG to 
SYMBOL TOG display it. 
COMPLEX 
ACTION: Display portions of the record. 
INVALID An overlay trap qualifier other than an overlay 
QUALIFIER designation was specified in a SET TRAP, 
FOR LIST TRAP» CLEAR TRAP» or SAVE TRAP 
OVERLAY command. 
TRAPS 
ACTION: Correct and reenter. 
INVALID A SET_TRAP command has an invalid trap type 
TRAP TYPE parameter value. 
XXX Xx 


ACTION: Reenter with a valid trap type. 


LINE An attempt was nade to reference a tine number 
NUMBERS in an explicitity named or default module 
NOT other than a program 


AVAILABLE compiled with the DEBUG option. 
ACTION: Check the home programe 


NO DEFAULT A command has been entered that requires a module 
MODULE specifications no module was specifieds and no 


' + a + Jim » | 
default modute is established. 


ACTION: Define a default module or reenter command 
with module specified. 


NO ENTRY A reference has been made to an entry point 

POINT xxx name xxxx which does nost exist}; or if an overlay 
qualifier has been supplieds it is not in that 
overlays 


ACTION: Check spelling or overtay qualifier; correct 
and reenter. 


COMPANY PRIVATE 


5-5 
COC - ADVANCED SYSTEMS DEVELOPMENT 
09/29/80 
ERS for CYBIL-CC Inter active Debugger . REV: D 


5.0 MESSAGES ++t+4e4¢4 4444 
5.1 DIAGNOSTIC MESSAGES 


NO FILE GR The file or debugger SCL procedure named in a 
PROCEDURE READ parameter does not existe 
xxx 
ACTION: Check spelling; check to see if the file is 
logically connected to the job. 
NG LABEL A GOTD command nas referenced a ftabel which 
xKXX does not exist in the current Debug command 
sequence. 
ACTION: Correct the Debug sequence accordingly. 
NO MODULE: A reference has been made to a module xxxx 
xXx X which does not exist; or if an overtay qualifier is 
supplieds the module is not in that overlay. 
Remember that module is al - 7 character name. 
ACTION: Correct and reenter. 
NO An overlay reference has been made in a nonovertay 
OVERLAYS environment. This error is detected at collect time 
if it occurs in a debugger SCL procedures, or if a 
specific overlay is referenced. 
ACTION: Confine Debug commands and address 
qualifiers to those acceptable in a 
nonoverlay environment. 
NO GQVERLAY The specified overlay does not existe DISPLAY_MAP 
(xxx x) indicates al! existing overiays. 
ACTION? Reenter with the corrected overlay 
designation. 
NO An attempt was made to reference a CYBIL-CC 
VARIABLE variabie xxxx, No such variable exists in the 
XXXX referenced or default module or the variable was not 
useds 
ACTIGN: Check spelling and the home program. 
NON - Field is not defined in current record. 
EXISTENT 
FIELD xxxx 


ACTION? Correct and reenter. 
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NOT IN A COLLECT_END command has been entered when 
COLLECT not in collect mode. 
MODE - 
COLLECT_LEND 
IGNORED 

ACTION: None, 
DPTION An invalid option code was specified in the 
CODE MUST option tist of a SET_LOUTPUT or SET_AUXILIARY 
BE Bs Dy» command. 
Ey I» Ry» 
Ts OR W 

ACTION: Reenter with ali valid option codes. 
POINTER A debug command has attempted to evaluate 
VARIABLE a pointer variabie that has not been set. 
NOT 
INITIALIZED 


ACTIDN: None. 


PROC xxxx TRACEBACK cannot proceed because the 
NOT CALLED specified procedure has never been called» 


ACTION: Enter another command. 


PROC xxxx Automatic variables are not available 
NOT IN because the procedure is not active. 
STACK 
ACTION: None. 
PROGRAM An attempt has been made with either GO or 
HAS EXECUTE to continue program execution from 


COMPLETED the point where program termination has been 


rAaAAam 


A 
reached. 


ACTION: Reenter specifying some other execution 
addresses» or issue QUIT. 


RECURSIVE The debugger SCL procedure or file named in 
READ OF the current READ parameter is a nested 
XXX X procedure or the current sequence, 


ACTIGN: Redesign sequence togic to avoid this 
Situation. 
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RELATIVE A modute offset is equal to or greater than its 
ADDRESS length. DISPLAY_MAP gives the program tength. 
OUTSIDE 
BLOCK 
ACTION: Check for the missing octal suffix (8) on 
the offset vaiue if octal was intended, 
Correct and reenter. 
RESPONSE In response to an errors warnings vetos or 
QUALIFIER interrupt of a Debug sequences a response keyword 
MUST BE has been followed by text beginning with other 
LINE OR than LINE»s SEQ or 3; (semi-colon). 
SEQ 


ACTION: Enter any desired valid response. 


SPECIFIED The given value is not in the specified set. 
VALUE NOT 


IN SET 
ACTION: Correct and reenter. 
STACK An invalid stack pointer has been found. 
POINTER 
DUTSIDE 
USER AREA 


ACTION: None. 


SUBSCRIPT A fieid of a record was specified after 


REQUIRED an array field in a variable entry 
AFTER without specifing a subscript. 
ARRAY xxxx 


ACTION: Correct and reenter. 


SUBSCRIPT A subscript vaiue has been specified that is 
VALUE i outside the range for the array. 
OUT OF 
RANGE 
ACTION: Correct and reenter. 
SYMBOL Internal errors 
NUMBER i 
NOT FOUND 


ACTION: Submit PSR. 
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SYMBOL Internal error. 
WITH 
RELOCATION 
TYPE i 
NOT 
ACCESSABLE : 
ACTION: Submit PSR. 
SYNTAX Command with keywords added is too fong 
ERROR - for buffer. 
COMMAND 
TOG LONG 
ACTION: Break command up if possible so fewer 
parameters are needed, 
SYNTAX A DISPLAY_MEMORY command has not been 
ERROR ~ entered. 
DISPLAY_ 
MEMORY 
MUST 
PRECEDE 
FORWARD OR 
BACKWARD 
ACTION: Enter a DISPLAY_MEMORY before doing FORWARD 
or BACKWARD. 
SYNTAX The parameter specified in the message has 
ERRGR - been given more that one value. 
DOUBLY 
DEFINED 
PARAMETER 
ACTION: Correct syntax and reenter. 
SYNTAX An incorrect parameter type was Founde 
ERROR — The message teits what was expected and what 
EXPECTING was found for the specified parameter. 
ACTION? Correct syntax and reenter. 
SYNTAX Either the address parameters are not 
ERROR - allowed together (ies proc and location) 
IMPROPERLY or another parameter is needed with 
QUALIFIED them (ies module must be supplied 
ADDRESS when proc and overiay are). 


ACTION: Check syntaxs correct and reenter. 
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SYNTAX The syntax described by the message is illegal. 
ERROR - 

INVALID 

ACTION: Correct syntax and reenter. 

SYNTAX An arithmetic operation has caused the integer 
ERROR - to become too targe. 

INTEGER 

OVERFLOW 


ACTIONS Check numeric parameters. If problem 
persistss submit PSR. 


SYNTAX The value entered is too large» 
ERROR — 
INTEGER 
TOO LARGE ~ 4 
ACTION: Correct and reenters 


SYNTAX The specified parameter must be entered for 
ERROR — this command. 
REQUIRED 
PARAMETER 
MISSING 
ACTION? Reenter command specifying the required 
parameter. 


SYNTAX String exceeds maximum allowable tength. 
ERROR - 
STRING 
OVERFLOW 
ACTION: Correct and reenter, 
SYNTAX CCBBG internal tables are filled. 
ERROR = 
TABLE 
OVERFLOW 
ACTION: Submit PSR. 
SYNTAX Not enough of the specified item were input. 
ERROR — 
TOG FEW 
ACTION: Correct and reenter. 
SYNTAX Too many of the specified item were input. 
ERRGR - 
TG0. MANY 


ACTION: Correct and reenter. 
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SYNTAX 
ERROR - 
UNBALANCED 


SYNTAX 
ERROR — 
UNKNOWN 
KEYWORD 


SYNTAX 
ERROR - 
VALUE DUT 
OF RANGE 


SYNTAX 
ERROR = 
VALUE 
RANGE NOT 
ALLOWED 


TO0 MANY 
BREAKPOINTS 


TOO MANY 
PROCEDURES 


TOO MANY 
NESTED 
COMMAND 
SEQUENCES 


Parenthesis or brackets are not matched. 


ACTION: Correct and reenter. 


The specified Keyword is not vatid for 


this command. 


ACTION: Check syntaxs correct and reenter. 
Parameter vatue is not within 

allowable range. 

ACTION: Check syntax» correct and reenter. 


A value range was specified for a 
parameter that cannot have a range. 


ACTION: Check syntax» correct and reentere 


The number of breakpoints has reached the maxi- 
mum allowed. 


ACTION: One or more existing breakpoints must be 
cieared before any new ones can be set. 


The number of debugger SCL procedures has 
reached the maximum allowed. 


ACTION: One or more existing groups must be cieared 
before any new ones can be set. 


The number of nested debugger SCL procedures has 
reached the maximum allowed. A READ or PAUSE 
command is not allowed until the current 
procedure is terminated and the previous 
procedure is resumed. 


ACTION: Enter GO to resume the previous sequence 
immediately. 
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TOD MANY The TRACEBACK output has reached its built-in 
TRACE feasibility timit. Program logic flow could 
LEVELS have errors. 
ACTION: Correct and reenter. 
TOG MANY The number of traps has reached the maximum 
TRAPS allowed. 
ACTION: Clear one or more existing traps before 
setting new ones. 
UNKNOWN The command text does not contain a syntactically 
COMMAND recognizable command name. If this error occurs 
in a debugger SCL procedures it is detected at 
collect times. HEL? CMDS list all valid 
command names.s 
ACTION? Check spelling. Reenter a vatid command. 
VARIABLE The referenced variable in an explicitly named or 
NAMES NOT default module must be in a CYBIL-CC program 
AVAILABLE compiled with the DEBUG option. 
ACTION: Check the home program. 
xxxx IS§ A subscript is included in a variable 
NOT AN deciaration for a variabie that is not 
ARRAY type array, 
VARIABLE 
ACTION: Correct and reenter. 
xxxx IS A pointer symbo!t (*) has been used in a 
NOT A variabie decfaration. for a variabie that 
POINTER i not type pointer. 
VARIABLE 
ACTION: Correct and reenter. 
xxxx IS A field name has been specified for a 
NOT A variable that cannot have fields. 
RECORD OR 
ARRAY OF 
RECORDS 


ACTION: Correct and reenter. 
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Je2 WARNING MESSAGES 


Warning messages issued by CCDBG are iisted befow. These 
messages have one of tne following forms: 


*¥WARN = message text 
OK? 


*CMD - (command text) *WARN ~— message text 
OK? 


These messages indicate by their wording the action that is 
taken if the user responds with a positive acknowledgement (YES>» 
ACCEPT» or GK). 


Warning messages can be suppressed by issuing a SET OUTPUT 


command that does not include the W parameter in its option 
list. The action indicated in the message automatically occurs. 
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Message 


AP RD RD AD RD RD WD EE AED US SD ED AD “SEN OED ORD OED ORD SRD eee 


ADAPTABLE STRING 


LENGTH WILL INCREASE 


FROM i TO i 
ADDRESS RANGE WILL 
BE TRUNCATED 


ALL WILL 3E CLEARED 


BREAKPOINT WILL BE 
SET AT ENTRY POINT 


EXISTING AUXILIARY 
FILE WILL BE 
CLOSED 


EXISTING BREAKPOINT 
WILL BE REDEFINED 


EXISTING CHECKPOINT 
FILE WILL BE 
OVERWRITTEN 


PROCEDURE xxx WILL 
BE REDEFINED 


LINE STARTS IN 
PARCEL 3.2 3KPT SET 
IN NEXT WORD. 


LINE n NOT 
EXECUTABLE - LINE m 
WILL BE USED 


fength or 


Pe See ae ee Sa eS ee ee ee ee ee ee ee es. er ee ee ee ee ee ee ee ee eS es del) + “ee 


Significance 


SU RD cme scent eee RD ca NEUE SACO “ANAL AON AEE SAREE ED A AONE ED -CEOCERD ND AEN ED SO COED AEE ED ORD AO ED OED AED AS AES ED ND TD OE AOD eR 


This CHANGE_VARIABLE command will 


fengthen the adaptable string variables 
and possibly overwrite other data. 


An address range for CHANGEs DISPLAY» 

or MOVE extends beyond the user field 
into DBUGs beyond the First 100 
(approximately) tocations. 


A CLEAR_LTRAPs» CLEAR_BREAKPOINT» 
CLEAR_PROCEDURE command has been 
with no parameters». 


or 
issued 


This warning is issued only if the 
specified address is an entry pointy» 
was not specified as such in a 
SET_BREAKPOINT command. 


but 


A SET_LAUXILIARY command has been issued 
which specifies a file name different 
from that of the existing auxiliary 
file. 


An attempt is being made to set a 
breakpoint where one already exists. A 
positive acknowledgement causes the new 
definition to override the old one. 


A CHECKPOINT command has been 
Qiving an existing file name, 


issued 


The name supplied in a SET_PROCEDURE 
command is that of a currently existing 
PROCEDURE.» <A positive acknowledgement 
causes the new definition to override the 
old one. 


Qne 15 bit instruction for this line 
of the program will be executed before 
breakpoint is honored. 


is not 
is nonexistent. A positive 


The specified tine number 
executable or 


acknowledgement causes tine m to be used 


instead. 
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PERMANENT CHECKPOINT 
FILE WILL BE 
RETURNED 


A CHECKPOINT command has been issued 
while a permanent suspend file exists 
without write or modify access. 


TRAP #ns types 
qualifierss WILL 
BE CLEARED 


A pending SET_TRAP command has a scope 
which overlays the scope of an existing 
trap of the same type. A positive 


+- ee eh Oe ee OO Oe 


52201 INFORMATIVE MESSAGES 


Informative messages issued by CCDBG are listed below. These 
messages have the form: 


message text 


Informative messages indicate the following: changes in the 
status of CCDBGs changes in the status of commands that process a 
lists, commands which confirm specific actions takens when a ftist 
element cannot be processed» and when there is no action to be 
takene 


After the informative message is issued» CCDBG does not pause 
for a responses except when the message announces the start or 
resumption of a CCD8G session. Any remaining elements in a tist 
are processed after reporting a tist element that cannot be 
processed. 


COMPANY PRIVATE 


5-15 


CDC - ADVANCED SYSTEMS DEVELOPMENT 


09729780 


ERS for CYBIL-CC [Interactive Debugger REV: D 


5.0 MESSAGES +44 444t+4444 
5.2.21 INFORMATIVE MESSAGE 


S 


Message 


COP AD LE ED AED A ED ED MANN ND TD GD SR Ada GN LD A ND OE LO ED 


CYBIL-CC INTERACTIVE 
DE BUG 


CY3BIL-CC INTERACTIVE 
DEBUG RESTARTED 


CYBIL MODULE 
NEXT» STACK POINTER 
ASSUMED IN REG B82 


DEBUG ABORTED 


DEBUG TERMINATED 


END COLLECT 


IN COLLECT MODE 
(sLEVEL n) 


Ce ee ee ee eS ee ee ee ee ee ee oe ee ee ee ee ee ee ee ee ee ee ee ee ee ee Sad Sa adaeed 


Significance 


After the program to be debugged has 

been loadeds this message is issued when 
CCDBG receives control. An initial set 
of traps and/or breakpoints should be 
established at this point before starting 
program execution. 


A CCDBG session has been resumed from 

the point where it was checkpointed. The 
system command statement DEBUG 
(RESUMEsfilename) has been entered 
Following the issue of a CHECKPOINT 
command. 


Previous modules in a traceback have not 


been CYBIL-CC modules. Continued 
traceback is possible only if register B2 
still contains a valid stack pointer. 


This message is issued in response to 
QUIT ABORT$ it appears in the dayfile as 
weil. 


This message is issued in response to 
QUIT or QUIT NORMAL$ it appears in the 
dayfile as well. 


Sufficient collect _end commands have been 
encountered to reduce the cottect level 
to zeros thus ending collect mode. 
Interactive command mode is resumed; 
entered commands are immediately 
executed. 


This message occurs when the user 


receives CCD8G control in collect mode; 


this was not the case when the user fast 
had control. <Any subsequent commands 
entered will no longer be executed 
immediatetys but will be checked for 
syntax and cofliected into a debugger SCL 


procedure for future execution. level in 


is included in the message if a nested 
coliect is in effect (n is greater than 
one). To end collect modes n coliect_end 


commands are required. 
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INTERRUPT IGNORED 


INTERRUPTED 


INTERPRET MODE 
TURNED OFF: 


INTERPRET MODE 
TURNED ON 


NO BREAKPOINT xxxx 


NO BREAKPOINT #n 


NO BREAKPOINTS 


wee a Be ae oe a Oe we Oe a Be Ee we ee 


wae a a ae a le ee a a 


CCDBG was already in interactive command 
mode when a terminal interrupt occurred. 
Since the purpose of a terminal interrupt 
is to place CCD8G in interactive modes 
the interrupt is ignored. 


A terminal interrupt has occurred while a 
debugger SCL procedure or a command which 
takes a list as a parameter was 
executing. 


As a result of clearing one or more 
traps» no traps remain that require 
interpret mode to be on. Subsequent 
program execution will be by direct 
execution of the machine instructions. 


A SET _TRAP command has been issued with 

a trap type that requires interpret mode 
of program executions ands currentliys 
interpret mode is off. Subsequent 
program execution wili be by interpreting 
ali machine instructions. 


A request has been made to DISPLAY» 
CLEAR» or SAVE a breakpoint at location 
xxXX¥Xe No such breakpoint exists. Any 
remaining list elements are processed. 


A request has been made to DISPLAY» 
CLEAR» or SAVE a breakpoint #n which does 
not existe. <Any remaining fist elements 
are processed. 


There are no breakpoints to DISPLAY» 
CLEAR» or SAVE. 
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PD AR ES CT I AL ND SEED ALES ED AD NS ED AED “ERD ED A aD 


NO 


NO 


NO 


NQ 


PAUSE IGNORED FROM 


Message 


PROCEDURE xxxx 


PROCEDURES 


xxxx TRAP yyyy 


TRAP #n 


TRAPS 


TERMINAL 


TIME LIMIT 


TRAP NUMBER IGNORED 
{N 


THIS CONTEXT 


eee ae eee a ee eee es ee ee en Se eee ee ee a ee eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee +> i 


Significance 


O00 ED DSS NE OE A AD ND ES ED AED A ANRD CRED RIED AID “SEE CNT OO AD LES SEEN AAD NY “TD ND SULLY ENED “EAD SEND SEND AGNES VEINS EID SERED TOD “RED NED EDS 


A request has been made to DISPLAY» 
CLEAR» or SAVE a debugger SCL procedure 
xxxx which does not exist.» <Any remaining 
list elements are processed. 


There are no debugger SCL procedures to 
DISPLAY» CLEAR» or SAVE. 


A request has been made to DISPLAY» 
CLEAR» or SAVE a user-defined trap of 
type xxxx with scope yyyys. No such trap 
existse Any remaining list elements are 
processed. 


A request has been made to DISPLAY» 


CLEAR» or SAVE a user-defined trap #n 
which does not exist. <Any remaining list 
elements are processed, 


There are no user-defined traps to 


DISPLAY» CLEARs or SAVE.» Note that the 
three default traps: ENDs ABORTs and 
INTERRUPT are never displayeds cleared or 
Saveds 


This message results from entering 


PAUSE while in interactive (non-collect) 
mode. 


A time limit interrupt has occurred while 
either the program or a CCD8G sequence 
was executing. A smali amount of time is 
lefts sufficient to do a SAVE_ALL and 
QUIT. To continue the sessions enter 
CHECKPOINTs followed by a QUIT and 
DEBUG(RESUME). 


A trap number has been specified as a 
list element in DISPLAY_TRAPs CLEAR_TRAP» 
or SAVE_TRAP command of a form for which 
trap numbers are not allowed. Any 
remaining fist elements are processed. 
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USER PROGRAM 


INTERRUPT PENDING 


USER RECOVER ROUTINE 


COMPLETED» x 
REQUESTED 


VARTABLE NAMES NOT 
AVAILABLE FOR xxx 


xxx TREATED AS 


> 


ee ee ee ee ee ee Se ee ee ee ee ee ee ee ee ee ee ee, ee ee ee eee ee ee ee ee ee 


A program interrupt was detected while 
execution of a CYBIL-CC statement 
compiled with the DEBUG parameter was in 
progress.» Uniess a second interrupt is 
issueds the interrupt is delayed until 
the execution of the current statement is 


completed. Howeverys in the interims a 


breakpoint or trap with no body or a 


PAUSE statement has been encountered, 


This message cautions that control is to 
be given to the user by some means other 
than the result of the terminal input. 
The terminal interrupt is acknowledged. 
Control is regained by entering GO or 
EXECUTE» causing the CYBIL-CC statement 
to comptete its execution. 


CCDBG issues this message after the user 
program has completed its recover 
routine by making an ABORT or ENDRUN 
request. 


Either program xxx is not a CYBIL-CC 
programs or it was not compiied with the 
DEBUG option explicitiy specified. 


A callect was found following a command 


other than SET_TRAP» SET_BREAKPOINTs or 
SET_LPROCEDURE$ or a COLLECT_END was found 
after a statement while not in collect 


mode. 
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backward i? bw 


change_defaults ; 


change_memory $ 


change_registers 


change_variable 3 
checkpoint i ck 
clear _auxiliary 3 


clear_breakpoint 


clear_interpret ;} 


clear_procedure 3 


clear _trap i ct 


cd 


cn 


2 er 


c¥ 


Caux 


cb 


ee 


ci 


cp 


numiocs=<integer> 
{formatszoct } dec $ adr $ 
{[module=<Cname>] 
Cproc=<name> ([.t€namerdlee.e] 
Covertay=(<integer>s<integer>)] 


<address_expro>Cmodute=<Cname>] 
Loffset=<integer>] value=<Xexpr> 
Cnumiocs=<integer>] Cindirect] 


ai bi x*€integer> 
value=<expr> Cindirect] 


var=<name> value=<expr> 
{module=<name>l(€ procz<name> 
Cet<namerlee.e] 


file=<name>d 


C[scope_expr] 
{b=<integer>(<ee><integerd}$ 
(<integerol<..><integer>] 
C<sep><integer>( <ee><integer>)]}]...2)) 
Coffset=<integer>) 
Loverlay=(<integer>s<integer>)] 
Cmodute=<name>]. 


Cerocedure=<name> ; 
(<named(<sepr><namerleres) ] 


C[typez<trap_type>difscope_expr] 
Ct=<integer>[<..><integerd]} 
(<integer>(¢..><integer>] 
C<sepr<integerdl <.e.><integer>)]].22)]) 
Lfoverlay=(<integer>ds<integer>)] 
Cmodule=<name>] [Cproc=<name> 
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clear_veto i cve 


C.-<namer>jJeer] 


dispilay_breakpoint it db Caddress_expr] 


display _default :} dd 


dispiay_map : dmap 


display _memory i dm 


display_procedure i dp 


display_registers { dr 


display status { ds 


display_trap + dt 


display_variable i dv 


execute 3} ex 


Cb=<integero>({<..><integerd]} 
(<integer>l<..>Xintegerd] 
{<sep><integerr>[<..><integer> I] ]..22)) 
Coffset=<integer>] 
Covertay=(<integerds<integer>)] 
Cmodule=<name>] 


{module=<named] 
Coverlay={<integer>s<integer>)] 


<address_expr> 

Cformatzoct : dec i adr $ hex] 
Cnumlocs=<integer>] 
Coffset=<integer>]{modul e=<name>] 
Cindirect] 


Cprocedure=<Cname> } 
(<named([<sep><namer>l..2)] 


Cp : fi ? Ca tt bt x#€l<integer>I7]) 
Cformatzoct i dec + adr i hex] 


Lindirect] 


Ctype=<trap_type>] Escope_expr] 
Ct=<integeroi<ee>Cintegerd i} 
(<integer>([<..><integer>] 
C<sepr<integerd>[ <..><integer>]]..2)] 
Covertayz=<integer>s<integer>)] 
Cmodule=<name>] [procz<name> 
CetnamerJes.el 


Cvar=Cname>] 

Cformatzoct {| dec ¢ hex] 
[module=<name>] Cprocz<name> 
{[e<name>dlers.] 


Caddress_expr] Coffset=<integer>] 
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forward i fw Nnumiocs=<integer > 
Cformatzoct $ dec { adr : hex] 


go Caddress_expr] Coffsets<integer>] 

goto label=<name> 

help ih C<subject> | <command_ named] 

label i: fa Name=<Cname> 

message i; me Ctext2!*{€<ascii>l]...'] 

move im source_expr destination_expr 
Cnumlocs=<integer>] 

pause i pa Ctext=*€<asciidlees!] 

quit Cnormal i abort] 

goad i or file + procedure = <name> 

save_all 3; savea fiile=<name> 


save_breakpoint ! saveb file=<name>(scope_expr] 
Cb=<integer>[<..><integerd]3 
(<integer>(<..><integer>] 
[<sep><integer>(<.»><integer>]].e2)] 
Coffset=<integer>] 
Covertay=(<integer>»s<integer>d)] 
Cmodule=<named] 


Save_procedure i: savep file=<name> 
Cprocedure=<name> i 
(<name> <sep><named]...2)/] 


file=<name> [type=<trap_type>d] 
{scope_expr] 
Ct2=<integer>[<..><integer>] 3 
(<integero[(<..><integer>d] 
C<sepr><integerd>([<..><integerd1)].+.)] 
Coverlay=(<integer>s<integer>d)] 
[modute=<named] ([Cproc=<name>d 
Ce<namerjJee.e] 


save_trap 3; savet 


set_auxiliary +; saux File=<name> lo=<options> 
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set_breakpoint ! sb Caddress_expr] 
Cmodulez<name>llCovertay=(<integer> 
s<integer>)] Coffset=<integer>] 
Cfirst=<integer>] Clast=<integer>]) 
{step=<integer>] [<collect><eoli 35> 
C<command_statement><eoli3>J... 
<collect_end>] 


set_interpret i si 

set l_output ! so flo=<options> 

set_procedure i so orocedure=<name> [<collect><eol!3> 
C<command_statenent><eolti 53> lee. 
<coltect_end>] 

set_trap i st type=<trap_type> [scope_expr] 
Coverlay=(<integer>ds<integer>d) ] 
[modulez<name>] Cproc=<name> 
Ce<Cnamerdjeee] Ctcollect><eoli;> 
C<command_statement><eoli s>J]eee 
<cotliect_end>] 

set_veto $} sve 

skipif it os <vaitue_l><relation><value_2> 


traceback ;: tb Centrypoint=<named] 
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